SetWindowProxyFSSpec

SetWindowProxyFSSpec
Header:	MacWindows.h		Carbon status:	Supported

Associates a file with a window.

OSStatus SetWindowProxyFSSpec (
    WindowRef window, 
    const FSSpec *inFile
);

Parameter descriptions

window: A pointer to the window with which the specified file is to be associated.
inFile: Set the file system specification structure to contain the data for the file to associate with the specified window. You can obtain an FSSpec structure by calling the function GetWindowProxyFSSpec.

function result: A result code.

DISCUSSION

Your application should call the SetWindowProxyFSSpec function to establish a proxy icon for a given window. The creator code and file type of the file associated with a window determine the proxy icon that is displayed for the window.

Because the SetWindowProxyFSSpec function won’t work without a saved file, you must establish the initial proxy icon for a new, untitled window with the function SetWindowProxyCreatorAndType, which requires that you know the file type and creator code for the file, but does not require that the file have been saved.

See also the function SetWindowProxyAlias.

SPECIAL CONSIDERATIONS

With Mac OS 8.5, you must save and restore the current graphics port—by calling the QuickDraw functions GetPort and SetPort—around each call to the SetWindowProxyFSSpec function.

VERSION NOTES

This function is available with Mac OS 8.5 and later.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.